package com.example.game_community.config;

import org.springframework.context.annotation.Configuration;
import org.springframework.web.servlet.config.annotation.CorsRegistry;
import org.springframework.web.servlet.config.annotation.WebMvcConfigurer;

/**
 * 全局跨域配置类
 * <p>
 * 实现WebMvcConfigurer接口配置CORS规则
 * 注意：当存在Spring Security时需要额外配置
 */
@Configuration
public class CorsConfig implements WebMvcConfigurer {

    /**
     * 配置跨域访问规则
     * @param registry CORS注册器
     *
     * allowedOrigins: 允许跨域的域名（生产环境应替换为具体前端地址）
     * allowedMethods: 允许的HTTP方法类型
     * allowedHeaders: 允许的请求头字段
     * allowCredentials: 是否允许发送cookie凭证
     * maxAge: 预检请求缓存时间（秒）
     */
    @Override
    public void addCorsMappings(CorsRegistry registry) {
        registry.addMapping("/**")  // 匹配所有接口路径
                .allowedOriginPatterns("*")  // 使用通配符模式允许所有源
                .allowedMethods("GET", "POST", "PUT", "DELETE", "OPTIONS")  // 允许的请求方法
                .allowedHeaders("*")  // 允许所有请求头
                .allowCredentials(true)  // 允许携带cookie
                .maxAge(3600);  // 预检请求缓存时间1小时
    }
}